home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / demos / pl_demo.lzh / DEMO.TXT next >
Text File  |  1990-06-30  |  16KB  |  377 lines
  1.                        LookIt! 1.0 Demo
  2.                        PopIt!  1.0 Demo
  3.                 Programs written by Doug Harrison
  4.           Copyright 1990 CodeHead Software & Doug Harrison
  5.                         All Rights Reserved.
  6.           ------------------------------------------------
  7.  
  8.  
  9. Packing List
  10. ------------
  11.  
  12. The following files are included in the official Demo release:
  13.  
  14.    a. LOOKDEMO.PRG
  15.    b. POPDEMO.ACC
  16.    c. REGACC.PRG
  17.    d. DEMO.TXT
  18.  
  19. If you receive a disk or archive lacking any of these files, then you
  20. have an unauthorized version. Please see "Distribution Policy" below for
  21. instructions regarding distribution of these files.
  22.  
  23.  
  24. Distribution Policy
  25. -------------------
  26.  
  27. You may freely distribute the LookIt! and PopIt! demos, as long as all
  28. files listed under "Packing List" are included. Any alteration of any of
  29. these files for any reason is forbidden.
  30.  
  31.  
  32. Getting Started
  33. ===============
  34.  
  35.    Before we discuss the PopIt! and LookIt! demos, you should place
  36. REGACC.PRG (RegAcc) in the AUTO folder of your boot disk (and
  37. POPDEMO.ACC in the root directory) and reset your computer. RegAcc is
  38. a tiny terminate and stay resident program which gathers information
  39. about desk accessories as they load, information impossible to obtain
  40. once the computer has booted and the GEM Desktop has appeared. PopIt!
  41. uses this information in providing its desk accessory hotkey services,
  42. and LookIt! uses this information to provide a menu bar operable solely
  43. from the keyboard. Even though REGACC.PRG is over 3,000 bytes long, once
  44. it becomes resident, it never requires more than 1,000 to 1,500 bytes of
  45. your memory.
  46.  
  47.  
  48.                         PopIt! Demo Version 1.0
  49.                         =======================
  50.  
  51.  
  52. Installing PopIt!
  53. -----------------
  54.  
  55.    As described above, you first need to copy REGACC.PRG to your AUTO
  56. folder. Then place POPDEMO.ACC in the root directory of your boot drive
  57. and reset your computer. After the GEM Desktop has appeared, select
  58. PopIt! from the Desk menu; the PopIt! window will appear, and in it you
  59. will find a scrollable list containing the names of all the desk
  60. accessories currently loaded (including those inside MultiDesk- version
  61. 2.0 or later is required).
  62.  
  63.  
  64. Assigning Hotkeys
  65. -----------------
  66.  
  67.    When you run PopIt! for the first time (and every time for the Demo
  68. version), no hotkeys will be assigned. To assign a hotkey to a desk
  69. accessory, click once on the desk accessory name in the PopIt! list,
  70. and then click on the "Assign button" (a short-cut is to Control-click
  71. on the name). Observe the "info line" in the window; it will state
  72. "Press a HotKey combination." The legal key combinations include: the
  73. alphabetic keys, numeric keys (including the keypad), the punctuation
  74. keys, the space key, the function keys, and any member of these sets
  75. combined with some combination of the Alternate, Control, Left-shift,
  76. and Right-shift keys (Alt, Ctrl, LS, and RS, respectively; LS and RS are
  77. distinct keys). Since these hotkeys will be active no matter what program
  78. you are running, you should strive to choose key combinations unlikely
  79. to be used by any program, because once RegAcc sees a keypress PopIt! is
  80. waiting for, that keypress is stolen, and a foreground program will not
  81. register it. Good choices include combinations like Ctrl-Alt-Key,
  82. LS-Ctrl-Key, etc.
  83.  
  84.    Once you have entered a hotkey, you may later want to change it.
  85. Select the accessory as described above, and press the new combination.
  86. Press Undo to clear the hotkey definition. Press Return, Enter, or Esc
  87. to cancel the assignment and keep the old definition.
  88.  
  89.    Note that several important features are inactive in the Demo version
  90. of PopIt! Among them are the abilities to save, load, and print
  91. configuration files, which can contain hotkey definitions for as many
  92. as 50 desk accessories. Naturally, the full version of PopIt! loads a
  93. default configuration file at boot-time, so that hotkeys are assigned
  94. automatically every time you turn on or reset your computer.
  95.  
  96.  
  97.                         LookIt! Demo Version 1.0
  98.                         ========================
  99.  
  100.  
  101. Overview
  102. ========
  103.  
  104.    LookIt! is an incredibly fast, easy to use ASCII file viewer and
  105. binary file editor. It features a custom user interface which overcomes
  106. many shortcomings in GEM. Some of LookIt!'s feature include:
  107.  
  108.    - super-fast text display, Blitter/Turbo ST not required
  109.  
  110.    - as many as 32 files can be held simultaneously in memory
  111.  
  112.    - fast regular expression as well as exact match searching
  113.  
  114.    - saveable search strings (18 are available)
  115.  
  116.    - binary file editing on both the hexadecimal and ASCII
  117.      representations of binary files
  118.  
  119.    - flexible display options, including color and font size control in
  120.      high resolution modes
  121.  
  122.    - printer options allow 40 byte strings to be sent before/after each
  123.      file and provide for draft/final and condensed print modes; margins
  124.      may be set and headers printed
  125.  
  126.    - may be installed as an application for the GEM Desktop or
  127.      CodeHead's HotWire, to let you show files by double-clicking them
  128.  
  129.    - flexible command line options allow loading of CFG files from
  130.      paths other than the default, automatic printing of files, wildcard
  131.      expansion
  132.  
  133.    - a menu bar operable solely from the keyboard (try Alt-F and then
  134.      the arrow keys, Return, Esc, or Undo; don't forget the mouse works
  135.      as usual!)
  136.  
  137.    - hotkeys for dialog box buttons and edit fields (use Alt-letter if
  138.      edit fields are present; otherwise the letter alone suffices)
  139.  
  140.    - keyboard equivalent for Cancel buttons; Esc, Ctrl-Esc, Alt-Esc, and
  141.      Undo all exit a menu/dialog/alert
  142.  
  143.  
  144. Part 1: Essential Concepts
  145. ==========================
  146.  
  147.  
  148. The File List
  149. -------------
  150.  
  151.    The central LookIt! concept is the file list. The file list may
  152. contain up to 32 files at any given time (the demo version is limited to
  153. a maximum of two files, and the maximum file size for the demo version is
  154. 40K bytes). You can step forward and backward through the list, or you
  155. can choose a file directly from a scrollable list containing the filenames.
  156.  
  157.  
  158. The Display
  159. -----------
  160.  
  161.    LookIt! has two display screens; the "GEM screen" provides a menu
  162. bar, while one views files from the "View screen." Assuming use of
  163. the standard monitors, the View screen provides a full 80 columns,
  164. and in monochrome, it supports the 50 line mode. LookIt! requires
  165. a graphics mode resolution of at least 640x200 pixels, which is the
  166. ST medium resolution mode.
  167.  
  168.  
  169. View Mode
  170. ---------
  171.  
  172.    Since LookIt! supports viewing of both ASCII and binary files, each
  173. file has an associated type, which controls the view mode.
  174.  
  175.  
  176. Opening a File
  177. --------------
  178.  
  179.    To open a file, select File Open from the menu bar. You will be
  180. presented with a custom file selector, which is a bit different from
  181. the GEM item selector and other replacements. Some of the enhancements
  182. include directory navigation via constructs like "..\..\SRC" and much
  183. improved editable field text editing (note that to back out one
  184. directory level, you should click on the name of the directory in the
  185. "Path" line or type "..\" followed by Return). File selection works
  186. much like the GEM item selector, except that you may select multiple
  187. files, adding them to the file list. Since the file list only has room
  188. for 32 entries (two for the Demo version), any files above this limit are
  189. ignored; that is, if you select 100 files, LookIt! will only acknowledge
  190. the first n entries. However, if there isn't enough space in the file
  191. list for the files LookIt! does acknowledge, you will be asked to remove
  192. enough files from the list to make room for the new ones (this applies to
  193. the _number_ of files, not the memory they require; LookIt! handles memory
  194. management itself).
  195.  
  196.    LookIt! provides several standard file extensions, and it automatically
  197. opens files with these extensions in the proper view mode, Text or Binary.
  198. Files that do not match any of the extensions are opened in Text mode by
  199. default. You can override this as